在 Windows 上安装 Next.js

本指南帮助你安装 Next.js Web 框架并在 Windows 上启动和运行。

Next.js 是一个框架，用于基于 React.js、Node.js、Webpack 和 Babel.js 创建由服务器呈现的 JavaScript 应用。 它基本上就是 React 的项目样板，精巧之处在于其着眼于最佳做法，可使你以简单、一致的方式创建“通用”Web 应用而几乎不需要进行任何配置。 这些由服务器呈现的“通用”Web 应用有时也称为“同构”，意味着代码在客户端和服务器之间共享。

有关 React 和其他基于 React 的 JavaScript 框架的详细信息，请参阅 React 概述页。

本指南假定你已完成设置 Node.js 开发环境的步骤，具体包括：

建议在使用 NodeJS 应用时使用适用于 Linux 的 Windows 子系统，以获得更高的性能速度和更好的系统调用兼容性，并在运行 Linux 服务器或 Docker 容器时实现奇偶校验。

重要

使用 WSL 安装 Linux 分发版将创建一个存储文件的目录：\\wsl\Ubuntu-20.04（将 Ubuntu 20.04 替换为你要使用的任何 Linux 分发版）。 要在 Windows 文件资源管理器中打开此目录，请打开 WSL 命令行，使用 cd ~ 选择主目录，然后输入命令 explorer.exe . 注意不要在装载的 C 驱动器 (/mnt/c/Users/yourname$) 上安装 NodeJS 或存储要处理的文件。 这样会显著延长安装和生成的时间。

安装 Next.js，包括安装 next、react 和 react-dom：

打开 WSL 命令行（如 Ubuntu）。

创建新项目文件夹 mkdir NextProjects 并输入以下目录：cd NextProjects。

安装 Next.js 并创建项目（将“my-next-app”替换为你喜欢的任意应用名称）：npx create-next-app my-next-app。

安装程序包后，将目录更改为新应用的文件夹 cd my-next-app，然后使用 code . 在 VS Code 中打开 Next.js 项目。 这将使你能够查看已为应用创建的 Next.js 框架。 请注意，VS Code 在 WSL-Remote 环境中打开了应用（如 VS Code 窗口左下角的绿色选项卡中所示）。 这意味着，当你使用 VS Code 在 Windows OS 上进行编辑时，它仍会在 Linux OS 上运行应用。

安装 Next.js 后，需要知道以下 3 个命令：

打开集成在 VS Code 中的 WSL 终端（“视图”>“终端”）。 确保终端路径指向项目目录（即 ~/NextProjects/my-next-app$）。 然后尝试使用以下命令运行新的 Next.js 应用的开发实例：npm run dev

本地开发服务器将启动，项目页面生成好后，终端将显示“已成功编译 - 在 http://localhost:3000 上准备就绪”。 选择此 localhost 链接以在 Web 浏览器中打开新的 Next.js 应用。

在 VS Code 编辑器中打开 pages/index.js 文件。 查找页面标题 Welcome to Next.js!，并将其更改为 This is my new Next.js app!。 在 Web 浏览器仍然打开到 localhost:3000 的情况下，保存你的更改；请注意，热重载功能会自动在浏览器中编译和更新更改。

让我们看看 Next.js 是如何处理错误的。 删除 结束标志以使标题代码现在如下所示：This is my new Next.js app!。 保存此更改；请注意，浏览器和终端中将显示“无法编译”错误，以告知你需要 的结束标志。 替换 结束标志，保存，然后页面将重载。

你可以通过选择 F5 键或转到菜单栏中的“视图”>“调试”(Ctrl+Shift+D) 和“视图”>“调试控制台”(Ctrl+Shift+Y)，将 VS Code 的调试程序与 Next.js 应用结合使用。 如果在“调试”窗口中选择“齿轮”图标，则将为你创建启动配置 (launch.json) 文件，以保存调试设置的详细信息。 若要了解详细信息，请参阅 VS Code 调试。

若要了解有关 Next.js 的详细信息，请参阅 Next.js 文档。